| Availability |
1.0 |
| Description |
Scans the specified documents for instances of the specified tags (or, if no tags are specified, for all tags in the document) and formulates browser-specific references to them. This function is equivalent to calling getElementsByTagName() and then calling dreamweaver.getElementRef() for each tag in the nodelist. |
| Arguments |
NSorIE, sourceDoc, {tag1}, {tag2},... {tagN} |
|
 |
The first argument must be either "NS 4.0" or "IE 4.0". The DOM and rules for nested references differ in Navigator 4.0 and Internet Explorer 4.0. This argument specifies for which browser to return a valid reference. |
|
The second argument must be "document", "parent", "parent.frames[number]", "parent.frames['frameName']", or a URL. document specifies the document that has the focus and contains the current selection. parent specifies the parent frameset (if the currently selected document is in a frame), and parent.frames[number] and parent.frames['frameName'] specify a document that is in a particular frame within the frameset containing the current document. If the argument is a relative URL, it is relative to the extension file. |
|
The third and subsequent arguments, if supplied, are the names of tags (for example, "IMG", "FORM", "HR"). |
|
| Returns |
An array of strings, each a valid JavaScript reference to a named instance of the requested tag type in the specified document (for example, "document.myLayer.document.myImage") for the specified browser. |
|
|
Dreamweaver returns correct references for Internet Explorer for A, AREA, APPLET, EMBED, DIV, SPAN, INPUT, SELECT, OPTION, TEXTAREA, OBJECT, and IMG tags. |
|
Dreamweaver returns correct references for Navigator for A, AREA, APPLET, EMBED, LAYER, ILAYER, SELECT, OPTION, TEXTAREA, OBJECT, and IMG tags, and for absolutely positioned DIV and SPAN tags. For DIV and SPAN tags that are not absolutely positioned, Dreamweaver returns "cannot reference <tag>". |
|
Dreamweaver does not return references for unnamed objects. If an object does not contain either a NAME or an ID attribute, then Dreamweaver returns "unnamed <tag>". If the browser does not support a reference by name, Dreamweaver references the object by index (for example, document.myform.applets[3]). |
|
Dreamweaver does return references for named objects contained in unnamed forms and layers (for example, document.forms[2].myCheckbox). |
|
|
When the same list of arguments is passed to getObjectTags(), the two functions return arrays of the same length and with parallel content. |
| Example |
dreamweaver.getObjectRefs("NS 4.0", "document", "IMG"), depending on the contents of the active document, might return an array with the following items: |
|
|
"document.bullet" |
|
"document.layers['headerLayer'].document.header" |
|
"document.photoLayer.document.headshot" |
|
 |
|